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(57) Abstract: The invention uses a state machine (202,204) to 
control the flow throughout a Web site including the execution 
of business logic (206), error handling and dispatching based on 
both user and programming events. This state machine (202,204) 
is used as input to a flow processor (208) and therein guides the 
system. The flow processor (208) controls a series of online func- 
tions including HTML links, HTML form submissions, form pro- 
cessing, business logic execution, and business logic exceptions 
into one simple-to -manage element. Any required change to the 
logic flow of the system can be made by modifying just the flow 
processor itself, without necessary changes to the referenced on- 
line functions. 
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SYSTEM FOR MANAGING LOGICAL PROCESS FLOW 
IN AN ONLINE ENVIRONMENT 

COPYRIGHT NOTICE 
5 [0001] A portion of the disclosure of this patent document 
contains material which is subject to copyright protection. The copyright 
owner has no objection to the facsimile reproduction by anyone of the 
patent document or the patent disclosure, as it appears in the Patent 
and Trademark Office patent file or records, but otherwise reserves all 
10 copyright rights whatsoever. 

[0002] This application claims priority from provisional application 
"System for managing logical process flow in an online environment", 
Application No. 60/236,898, filed September 28, 2000, and incorporated 
15 herein by reference. 

Field of the Invention: 

[0003] The invention relates to systems for structuring the 
process flow in computational environments and specifically to a system 
20 and a method which allows the separate development of the design 
elements and the underlying logical processes in an online environment. 

Background of the Invention: 
25 [0004] In the environment of an e-commerce application, such as 
a web server together with a series of web pages and web-based 
application, navigation of dynamic web pages is a complex task that 
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usually requires a combination of various solutions to perform. These 
solutions make it difficult for a developer to determine the flow of a Web 
site and even more difficult to modify it. 

[0005] In a Web site with dynamic content, herein referred to as 
5 a "dynamic Web site", information is typically displayed to the user in the 
form of hypertext markup language or HTML code (both static HTML 
and dynamically generated HTML), and business logic is executed or 
followed based upon actions initiated by the users. For example, when 
making a purchase on a Web site a user is often presented with a 

10 summary order page. This is an HTML page that has been dynamically 
generated. It shows the items in their current order, total cost and 
pertinent information. When they press or click the "buy" button it 
causes business logic to be executed that will update databases, notify 
suppliers, etc. When these operations have successfully completed, a 

15 success page must be displayed to the user. 

[0006] A problem with this approach is that the business logic is 
subject to a failure for a variety of reasons, some of which are expected 
such as an item being out of stock, and others which are unexpected 
such as databases not reachable. In a typical system, each of these 

20 errors requires specialized handling. Current solutions offered today 
usually employ a combination of solutions including: direct navigation 
via HTML links, dynamic navigation via client-side JavaScript, dynamic 
navigation via hand-written server side solutions including servlets, JSP 
tags, Cold Fusion tags, server side Java beans and ASP pages, to 

25 name only a few. However, all of these methods suffer the 
disadvantage of being complex and cumbersome to use, require lengthy 
development times, are inflexible to change and can rarely be modified 
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on the fly to effect real-time changes to the business logic. Since they 
incorporate elements of both user interface design and business logic 
processing, current methods require considerable operator expertise in 
both of these areas, and prevent some, such as business analysts, from 
5 participating fully in the development of the e-commerce application. 

Summary of the Invention: 

[0007] The invention uses a state machine-like mechanism to 
describe the flow throughout the Web site including the execution of 

10 business logic, error handling and dispatching based on both user and 
programming events. This state machine, herein called a "webflow", 
rather than just being a diagram describing the existing code, is actually 
used as input to a webflow processor that guides the system. It 
combines Web links, form submissions, form processing, business logic 

15 exection, and business logic exceptions into one simple-to-manage 
schema. Any required change to the logic flow of the system can be 
made by modifying only the webflow itself. No underlying code need be 
modified. 

[0008] As mentioned above, a key element of the invention is the 
20 webflow mechanism. The webflow guides the progress of the 
interaction of the user with the actual e-commerce application system. 
In many cases, the e-commerce system will be a Web site hosted on a 
Web server, although the invention can be used with any other form of 
user interactive system. Different types of application code can be used 
25 to track and to modify the user interface. These codes may in one 
embodiment include Java Servlet Pages (JSP) to present information to 
the user that includes a series of buttons, links and HTML elements; 



WO 02/27510 



PCT/US01/30260 



4 

input processing code which is used to modify the user input; and 
pipeline processing code, which may be stateless session Enterprise 
Java Bean (EJB) or manipulating entity EJB. An entry for each code 
type is included in a property file used to configure the webflow. The 

5 property file describes the various states of the JSP, HTML, and input 
and pipeline processing features, and also describes the transitions 
between those features. The transitions may include links, buttons and 
processing results which determine how the output of one feature 
affects another feature. 

10 [0009] When properly configured, the webflow represents a tree 
structure along which the user is guided. The tree structure includes 
presentation nodes and actions nodes. Presentation nodes are what 
the customer actually sees in their browser, for example, these may 
include HTML and JSP files. While viewing the output from a 

15 presentation node, the customer's data is stored in a pipeline session. 
A pipeline session is a set of attributes which may in one embodiment 
be name value pairs which hold pertinent data on a given customer 
during a given session. Since the webflow acts like a state like 
machine, the pipeline session defines a current state for a given 

20 customer. The data stored in the pipeline session are used throughout 
the webflow to provide information to other features and services. 
[001 0] The other type of node is an action node. Action nodes do 
the actual work for the e-business site. In one embodiment, there are 
two types of action nodes: input processors and pipelines. Input 

25 processors handle the attributes of the pipeline session. Typically the 
input processor may either: (a) put the attribute in the pipeline session; 
(b) modify the value of existing attributes within that pipeline session; or 
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(c) validate values of particular attributes within the pipeline session. A 
pipeline controls the flow of the business logic within the e-commerce 
site. Typically the pipeline comprises many pipeline components. A 
pipeline component is an object responsible for doing a particular 
5 portion of the business logic. Each pipeline component is thus a unit of 
business functionality. The e-commerce customer may combine the 
use of a webflow together with input processors and pipeline to modify 
their business functionality with ease of use and in real time. 

10 Brief Description of the Figures: 

[001 1] Figures 1 -3 shows a schematic block diagram of a state 
diagram in accordance with an embodiment of the invention. 
[0012] Figure 4 shows a schematic block diagram of an input 
processor state diagram in accordance with an embodiment of the 

15 invention. 

[0013] Figures 5-6 shows a schematic block diagram of a 
pipeline diagram in accordance with an embodiment of the invention. 
[0014] Figure 7 shows a schematic block diagram of a 
webflow/pipeline embodiment of the invention. 
20 [0015] Figure 8 shows a schematic of a login application which 
includes an embodiment of the invention. 

[0016] Figures 9-25 show steps in the creation of a Web site 
having a webflow in accordance with an embodiment of the invention. 
[0017] Figures 26-28 show function invocation time-lines in 
25 accordance with an embodiment of the invention. 
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Detailed Description of the Preferred Embodiment: 
[0018] As mentioned above, a key element of the invention is the 
webflow mechanism. The webflow guides the progress of the 
interaction of the user with the actual e-commerce application system. 
5 In many cases, the e-commerce system will be a Web site hosted on a 
Web server, although the invention can be used with any other form of 
a user interactive system. Different types of application code can be 
used to track and to modify the user interface. These codes may 
include Java Servlet Pages (JSP) to present information to the user that 

10 includes a series of buttons, links and HTML elements; input processing 
code which is used to modify the user input; and pipeline processing 
code, which may be stateless session Enterprise Java Bean (EJB) or 
manipulating entity EJB. An entry for each code type is included in a 
property file used to configure the webflow. The property file describes 

15 the various states of the JSP, HTML, and input and pipeline processing 
features, and also describes the transitions between those features. 
The transitions may include links, buttons and processing results which 
determine how the output of one feature affects another feature. 
[0019] The webflow describes a state machine or state diagram 

20 that defines the transitions between presentation and action nodes, in 
effect determining how a user moves between these nodes. In the 
environment of a Web server the webflow can be implemented by a 
servlet application. To invoke the webflow mechanism the commerce 
developer must simply construct Web pages that then invoke the 

25 webflow application servlet. This is an instruction to the webflow to 
determine the state of events. 
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[0020] One of the enabling technologies for this webflow is the 
separation of work responsibilities that it employs. All work is broken up 
into one of three types of work: 

1 . Presentation/Display: which is determined either by HTML or JSP 
5 files, and represents what the user actually sees (in their browser). 

2. Form Processors: which process HTML form submissions into a 
compatible Java data format, and stores the resultant objects in the 
pipeline session for use by the webflow and other applications. 

3. Pipelines: which represent a conglomeration of business logic 
1 0 components that are executed in serial, one after the other, and that act 

upon the contents of the pipeline session. 

[0021 ] This separation of responsibilities allows for a fine-grained 
control over the webflow that would not be possible if everything was 

15 written as a few large servlets or application service provider (ASP) files. 
Some of the benefits provided by the invention include: 
[0022] The developer can change where the HTML link points to 
or where the form is posted to by modifying the webflow configuration. 
In the past this required the developer to edit the underlying HTML. 

20 [0023] Forms and non-forms-related HTM L pages can be deleted 
from the users display by modifying the webflow. In the past this 
required the developer to edit the HTML, JavaScript and/or the server 
side components. 

[0024] Business logic functionality can be added or deleted by 
25 modifying the pipeline configuration and the server side components. 



WO 02/27510 



PCT/US01/30260 



8 

[0025] Errors in the business logic can be managed by modifying 
the webflow. Existing systems either provide no help for errors or only 
allow successful versus unsuccessful execution of the pipeline. 
[0026] An embodiment of the invention includes structures and 
5 methods which allow the development of the design elements of an 
online environment to be separated from the development of the 
underlying logical processes. In one embodimentthe invention provides 
both a webflow and a pipeline mechanism. The webflow pipeline are 
flexible mechanisms designed to help a site administrator, develop or 

10 manage both the presentation and business logic in an e-commerce 
Web site, without the need for advanced programming skills. 
[0027] Several embodiments of the invention may be included in 
e-commerce development systems such as the BEA WebLogic 
Commerce Server product, produced by BEA Systems, Inc., although 

15 it will be evident to ones skilled in the art that the invention can be used 
with an e-commerce development platform, application, or application 
server, hereinafter simply referred to as a "commerce server." 

Presentation and Action Nodes 

20 [0028] When properly configured, the webflow represents a tree 
structure along which the user is guided. The tree structure includes 
presentation nodes and actions nodes. Presentation nodes are what 
the customer actually sees in their browser, for example, these may 
include HTML and JSP files. While viewing the output from a 

25 presentation node, the customer's data is stored in a pipeline session. 
A pipeline session is a set of attributes which may in one embodiment 
be name value pairs which hold pertinent data on a given customer 
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during a given session. Since the webflow acts like a state like 
machine, the pipeline session defines a current state for a given 
customer. The data stored in the pipeline session are used throughout 
the webflow to provide information to other features and services. 
5 [0029] The other type of node is an action node. Action nodes do 
the actual work for the e-business site. In one embodiment, there are 
two types of action nodes: input processors and pipelines. Input 
processors handle the attributes of the pipeline session, and may put 
the attribute in the pipeline session; modify the value of existing 

10 attributes within that pipeline session; or validate values of particular 
attributes within the pipeline session. A pipeline controls the flow of the 
business logic within the e-commerce site. Typically the pipeline 
comprises many pipeline components. A pipeline component is an 
object responsible for doing a particular portion of the business logic. 

15 Each pipeline component is thus a unit of business functionality. 

[0030] Events occur as the user interacts with the presentation, 
for example by operating the Web site. Events may result in various 
outputs including a success, failure or exception. Depending on these 
outputs, the subsequent transitions are chosen by referencing on the 

20 webflow. 

[0031 ] Pipeline sessions are also used for pipeline components. 
Through a pipeline session a pipeline component can share data 
amongst themselves, 

and with presentation nodes. In one embodiment of the invention, a 
25 pipeline session can be a Java class that is unique to each user 
interacting with the web application. A pipeline session is accessible as 
an object in action nodes and accessible through a tag library in 
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presentation nodes. When the system first boots up, a webflow 
definition or configuration file (called a webflow.properties file) is read to 
determine the configuration. This definition or properties file defines the 
state diagram of those presentation and action nodes which are linked 
5 by transitional events. 

Webflow and Pipeline Elements 

[0032] The webflow pipeline are flexible mechanisms designed 
to help a site administrator, developer or manager to manage both the 
10 presentation and business logic in an e-commerce Web site, withoutthe 
need for advanced programming skills. 

[0033] In particular, the invention allows an e-commerce 
developer to separate presentation (such as HTML and JavaScript) from 
business logic (such as database updates and implementation of 
15 business rules). To create and maintain this separation, a Commerce 
Server, in accordance with the invention, may make use of the following 
six technologies: 

1. HTML: Standard HTML supported by a typical browser, for 
example, Netscape Navigator or Microsoft Internet Explorer. Throughout 

20 this document, the term HTML refers to both HTML and JavaScript. 

2. JSP Tags: Customized tags used in the Java 2 Enterprise 
Edition (J2EE) platform. A Commerce Server can use JavaServer Page 
(JSP) tags to add dynamic display to the HTML pages, such as 
displaying the name of a customer who is currently logged in. 

25 3. Pipeline Components: Discrete units of server-side business 
logic, such as calculating tax or committing an order. A plurality of 
pipeline components can be combined into a Pipeline. 
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4. Pipeline Session: A storage location forstoring information about 
the current session (such as the current shopping cart) or more transient 
data (such as error messages about a customer's most recent input). 

5. Input Processors: Flexible mechanisms that handle input data, 
5 for example, form submission data. Some input processors may 

perform validation of customer data, or store customer data into the 
pipeline session for subsequent use by a Pipeline component. 

6. Webflow: A mechanism of logic which controls the flow of a 
customer's session through an application, for example, the pages 

10 displayed by the commerce server in a browser for the user to see, and 
also controls the execution of specific pieces of business logic. Pages 
generate events (the link or button the customer clicks) which result in 
the invocation of input processors pipelines. These may in turn either 
succeed or fail, from which the webflow decides which page to display 

1 5 or which piece of business logic to execute next. The webflow is in one 
embodiment configured by a webflow properties file. This webflow 
properties file can be modified and parsed in real-time to effect real-time 
changes to the Web site or application state diagram. Once parsed, the 
webflow embodies the logic of the properties file. 

20 [0034] This separation between presentation and business logic 
is beneficial for a number of reasons, one of which is from a 
customization/maintenance standpoint. In any given organization, 
different people within that organization may perform different tasks, and 
may specialize in a particular area. The methods offered by the 

25 invention in keeping the user interface separate from the business 
processes and the Java programming allows a development team to 
accomplish more in less time, and makes it easier for members of the 
team to focus on their particular areas of expertise or interest. 
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[0035] The six technologies described above can be considered 
as belonging to four development categories: presentation, business 
logic, state maintenance, and flow of control. 
[0036] HTML, JSP tags, and input processors comprise the 

5 presentation portion of the system. HTML is the display language 
understood by most Web browsers. JSP tags are used to translate 
information from the pipeline session to HTML. Input processors 
translate form-related data from HTML into a format that can be stored 
in the pipeline session. 

10 [0037] Pipeline components which contain pieces of business 
logic have no knowledge of HTML or any of the other presentation 
technologies. Instead, the pipeline session maintains all of the 
conversational state in the system. Similarly, the webflow governs the 
flow of control. Together, the webflow and pipeline serve to separate 

15 the presentation side of the e-commerce development from the logic 
side. 

[0038] An important benefit of the webflow and pipeline 
mechanisms is that they allow people with different levels of technical 
skill to customize both the presentation and business logic within an 

20 e-commerce site. Commerce engineers/JSP content developers, site 
administrators, and business analysts can divide Web site customization 
(and subsequent maintenance) activities based on their own expertise, 
interests, and job responsibilities. The software development team can 
spend their time extending the server packages to add functionality. 

25 Thus, some bottlenecks in the site development and maintenance 
process that exist with traditional systems are greatly reduced. 
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The Webflow Process 

[0039] Figure 1 shows a conceptual state diagram of a method 
according to the invention. As shown in Figure 1 , a user interacts with 
a Web site through a web browser 101. In this example, the user 
5 follows a link 106 from an origin to a destination 104. The origin 102 
may for example be a Java servlet page or an HTML page and 
represents the web page through which the user operates. The link 1 06 
may be an HTML link, while the destination may be another page. The 
originating node, in this case origin 102, invokes the webflow 

10 mechanism with the name of the originating node origin and an event, 
in this case, the reference to the link 106. The webflow searches for a 
match for this particular origin and event pair and invokes a destination 
node 1 04. In this way the transition from the origin to the destination is 
not predetermined by the link 106, as it would be in a static-programmed 

15 html system, but is instead enabled by the flexible mechanism of the 
webflow. 

[0040] Figure 2 shows an alternate example in which an input 
processor 1 18 is used to determine the input to the webflow and to alter 
the output destination. As shown in Figure 2 the origin 102 makes a call 

20 to the destination 1 04 via a link 1 06, as in the previous example. Again 
the webflow searches for a matching combination of origin and event 
pair. This time however, the matching combination found by the 
webflow is directed to a input processor 118. The input processor is 
invoked with the user data and depending on the result of the input 

25 processor, either a success or an exception may be returned. In this 
case the input processor is used to modify the link 106 to determine a 
different destination. 
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[0041] In Figure 2, the result of the input processor is a success 
and the destination 104 is invoked 1 14. The alternate example of what 
happens when an exception is returned is illustrated in Figure 3. In 
Figure 3, the link 1 06 is agairi used, as defined in the webflow properties 
5 file, to invoke input processor 114. In this example however an 
exception is recognized by the webflow, and it redirects the transition 
accordingly. A different destination is then invoked 105. 
Webflow Properties File 

[0042] Since every e-business is different, an embodiment the 
10 invention utilizes a properties file to manage the sequence (or flow) in 
which Web pages are displayed. This file can be modified to change the 
order of the Web pages, without having to edit each Web page 
individually. 

[0043] The webflow properties file configures the order of flow in 
15 which pages are displayed. This file describes a state diagram along 
which action nodes and presentation nodes are distributed. The 
presentation nodes include Java server pages and HTML files, and 
determine the visual output of the webflow as seen by the user. The 
action nodes represent the "behind the scenes" business logic events, 
20 and can be implemented as input processors and pipelines. Throughout 
Figures 4-6 arrows within the state diagram represent actual user or 
webflow-initiated events such as begin, end, link, button, success or 
exception. 

[0044] Figure 4 demonstrates a simple example of a state 
25 diagram represented by the webflow properties file. The webflow 
properties file describes the state diagram including all of the 
presentation nodes - "home. HTML" 132, "about.html" 136, "login.jsp" 
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140, and "verifyjogin.jsp" 144, together with all the action events that 
must take place within these action nodes. As shown in Figure 4, the 
process begins with a begin 1 30. The home.html page 1 32 is presented 
to the user. The home page is typically the first page a user encounters 
5 on a Web site. From here the user can follow an about link to an 
about.html file 136, for example to find information about the company 
or the Web site. Alternatively, the user may follow a log in link 138 
which leads to a login server page 140. 

[0045] The webflow as configured determines that the login 

10 servlet 140 must be pre-verified or validated by a login input processor 
144, and so passes control to the input processor via an invoke 142. 
The output of the input processor may be a success 146 in which case 
the webflow determines that control is returned to the home page 132, 
or else an exception 148 in which case the webflow determines that 

15 control is returned to the login, perhaps so that the login may be 
attempted again. At each step in the process presentation nodes such 
as home.html and about.html represent what the user sees in their 
browser. These presentation nodes may be implemented with HTML 
pages or JSP pages. Transitions between the pages occur when an 

20 event is activated. The action nodes in the webflow state diagram, for 
example the input processor 144, represent business logic in the 
application. This business logic may be implemented with Java code 
that executes as a result of an event. Action nodes may comprise input 
processors as above, for preprocessing data prior to execution, or 

25 pipelines to implement actual business logic steps. 

[0046] Transitions between pages, whether the pages are 
presentation nodes or action nodes, are driven by the occurrence of a 
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series of events such as "begin," which specifies a starting page that is 
typically, the home page; "end," which optionally specifies an ending 
page; "link," which represents the selection of a hyperlink; "button," 
which represents the submission of an HTML form; "success," which 
5 represents successful execution of an input processor or pipeline and 
that success string was returned; and "exception," which represents an 
unsuccessful execution of an input processor or pipeline, and issues an 
exception or failure message. 

[00471 The begin and end events typically point to the first and 
10 the last page of a Web site. Usually the begin event points to the home 
page. When the system first boots up the begin event is triggered and 
any webflow transitions included in that begin event are invoked by the 
page pointed to by the begin event. The link events allow the webflow 
to handle transitions between pages due to a hyperlink selection by the 
15 user, for example, the clicking on a link in a web page. To declare a link 
event in the webflow properties file the following syntax is used: 

originPage . link (linkName) =destination 



20 Wherein, 

originPage: = *.jsp| *.html | *.htm 

linkName: = namellsedlnOriginPage 

destination: = *.jsp| *.html | *.htm | inputProcessor | pipeline 

25 [0048] This is only one part pf the overall equation - the origin 
page, i.e., the web page in which the user is interacting, must also notify 
or invoke the webflow whenever a link event occurs. The following 
syntax is used to notify the webflow of a link event in an HTML page: 
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<A HREF= V^pplication/commercewf ? 
origin=originPage& 
event=link (linkName) ">someText</A> 

5 

Wherein, 

originPage: = *.jsp | *.html | *.htm 

linkName: = nameUsedlnPropertiesFile 

10 someText: = hyperLinkText 

[0049] Button events are used to handle requests generated by 
the user when submitting HTML forms. These forms are typically found 
on Web sites on pages in which a user is requested to press a button, 
15 or to click on a link, in order to forward registration information to an 
e-commerce business service. Button events can be declared within the 
webflow properties file using the following syntax: 

originPage .button (buttonName) =destination 

20 

Wherein, 

originPage: = *.jsp | *.html | *.htm 

buttonName: = nameUsedlnOriginPage 

destination: = *.jsp | *.html | Mitm | inputProcessor | pipeline 

25 

[0050] As before with link events, the origin page, which in this 
case is the form page containing the button, must be configured to 
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forward the request to the webflow. The following syntax can be used 
to declare a form that notifies the webflow of input information: 

<FORM METHODS POST" ACTIONS /application/ commercewf " > 
5 < INPUT TYPE ^HIDDEN NAME=origin VALUE= "originPage" > 

< INPUT TYPE =HIDDEN NAME = event 
VALUE= "button (buttonName) " > 

<INPUT TYPE= tt SUBMIT" VALUE= "submit But t onText " > 
</FORM> 

10 

Wherein, 

originPage: = *.jsp | *.html | *.htm 

buttonName: = nameUsedlnPropertiesFile 

15 [0051] The webflow properties file (webflow. properties) as used 
in the context of a web server or commerce server d irecting a Web site's 
content controls the display of the site's Web pages and initiates 
execution of the business logic associated with these pages. 
Generically, each line in the webflow.properties file can be written as: 

20 

<origin>. [<event>] [ (<e vent Name>) ]=< targe t> 

wherein, 

<origin>: = begin | <page> <extension> | 

25 <inputprocessorName> | <pipelineName> 

<event>: = link (<linkName>) | button (<buttonName>) | 

success | exception (<exceptionName>) 
<target>: = <page>. <extension> | <inputprocessorName> | 

<pipelineName> 
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<extension>: = jsp | html | htm | inputprocessor | pipeline 

[0052] Each line in the webf low. properties file comprises a 
name/value pair, separated by an equal sign (=). The name consists of 
5 the current state and a named event, and the value is a result state. In 
the webf low properties example shown below, the current state is 
"firstpage.jsp". The event is a button named "Next", and the result state 
is "nextpage.jsp". 

10 f irs tpage . j sp . button (next) =nextpage . j sp 

[0053] This webflow properties entry denotes that when a 
customer clicks the "Next" button from firstpage.jsp, the webflow will 
load nextpage.jsp. The home page may also be referenced in the 
15 webflow.properties file as 

begin=home . j sp 

[0054] Web pages that may be used with the webflow include 
20 .htm, .html, or jsp files, although it will be evident to one skilled in the art 
that other types of presentation file and application format can be used 
while remaining within the spirit and scope of the invention. In addition 
to the button event shown in the previous example, there is also a link 
event associated with these file types. 
25 [0055] Events can be given unique names because it is likely that 
a page has multiple events of the same type associated with it (for 
example both "previous" and "next" buttons on firstpage.jsp, each 
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requiring different result states). _ Event names can be used to 
differentiate between these events, as shown below: 

f irstpage . j sp . button (previous) -previouspage . j sp 
5 f irstpage . j sp . button (next ) -nextpage . j sp 

[0056] In cases where it is desired that all of the Web pages 
should reach a certain target page, one can substitute a wildcard 
character (*) for a specific page name in the current state. For example, 
10 if customers should be able to reach the home page from every page 
within the Web site, a line in the webflow.properties file would read: 

* . j sp . link (home) =home . j sp 

15 [0057] The webflow configuration, as stored in the webflow 
properties file, can be dynamically modified to effect dynamic changes 
to the webflow itself, and thus to the flow of business and presentation 
logic on the web site. To dynamically modify the webflow, these steps 
are undertaken: 

20 1 . Start a simple text editor like Notepad. 

2. Open the webflow properties file. 

3. Modify the file as necessary, using the syntax described in the 
previous sections. 

4. Save the modified file. 

25 There is no need to restart the server to view the changes. 
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Webflow and Web Pages 

[0058] To utilize the webflow mechanism, the URLs within the 
Web pages must include information that corresponds to a line in the 
webflow. properties file. Specifically, the URL must contain a page name 
5 and an event that match a current state in the webflow.properties file. 
So, for example, in the web page the following html text could be 
embedded: 

URL Within a <FORM> Tag in the Web Page 
10 <FORM method= n post" 

action=" <%=webf lowJSPHelper . createwebf lowURL 
pageContext, 11 login . j Bp 11 , button (createUser) " , false)%>"> 

[0059] The corresponding Line in the webflow.properties file 
15 would be: 

login . j sp .button (createUser) =nextpage . j sp 

Webflow Search Order 

20 [0060] There may be times when a transition in the webflow is 
missing (that is, no result state has been specified). To prevent any 
problem from being visible to the customer, the webflow can attempt to 
resolve missing transitions by searching through several possibilities to 
locate an alternate flow. These search possibilities are examined by the 

25 webflow mechanism in the following order: 

The webflow substitutes the wildcard character for the specific 
page, input processor, or Pipeline. 
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If wildcard substitution fails, the webflow produces a configuration 
exception relative to where it encountered the missing transition, and 
uses this as the result state. 

If contextual configuration exceptions do not allow the webflow to 
5 continue, the webflow combines the wildcard substitution with a generic 
exception, which it uses as the result state. 

If the previous attempts fail, the webflow will simply load a 
configuration error page. The configuration error page can be 
configured in the webflow.properties file. 

10 ' 

[0061] The search order attempts to prevent a missing transition 
in the webflow from interrupting a customer's experience on the Web 
site. Rather, in the very worst case, the webflow loads the configuration 
error page. If for some reason this file is missing, a predefined system 
15 error page can be used instead. 

[0062] For example, suppose the webflow mechanism is 
attempting to locate the missing transition login.jsp.link(home) in the 
webflow.properties file. The following list illustrates the alternate 
transitions that may be used by the webflow: 
20 • *.jsp.link(home) 

login.jsp.error(ConfigurationException) 

*.jsp.error(ConfigurationException) 

configurationerrorpage 



25 [0063] The webflow search order is also be performed for input 
processors pipelines that are missing in the webflow.properties file. The 
following list illustrates the alternate transitions that may be used by the 
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webflow for a missing transition 
ShoppingCartl P.in putprocessor.success : 
*.inputprocessor.success 

ShoppingCartlP.inputprocessor.error(ConfigurationException) 
5 • *.inputprocessor.error(ConfigurationException) 
conflgurationerrorpage 

[0064] Similarly, the following list illustrates the alternate 
transitions that may be used by the webflow for a missing transition 
10 ShoppingCartPC.pipeline.success: 
*.pipeline.success 

ShoppingCartPC.pipeline.error(ConfigurationException) 

*.pipeline.error(ConfigurationException) 

conflgurationerrorpage 

15 

Input Processors 

[0065] States in the webflow. properties file are not restricted to 
other Web pages. Input processors (IP's) are predefined classes that 
provide a way to indirectly carry out more complex tasks using the 

20 webflow mechanism. Input.processors reduce the need to incorporate 
complex Java code into the sever-based JSPs, and help maintain the 
separation between presentation and business logic. 
[0066] The role of input processors is to read data from.the HTTP 
ServletRequest that invokes the webflow, and use this data to create or 

25 update Java objects in a pipeline session. In addition to working with this 
data, some input processors may also validate information supplied by 
the customer. 
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[0067] Input processors are also declared in the webflow 
properties file. The following syntax can be used to declare an input 
processor: 

5 begin=/home . html 

home .html . link (about) =/CMPAP/ solution/ about . html 
home .html .button (login) =MyLoginIP . input Processor 
MyLoginIP . input Processors com . commerce . . CMPAP . MyLoginIP 

10 [0068] Input processors are used to examine data and to 
determine events. If an input processor terminates execution 
successfully, it should return a success string, or success event, 
otherwisethe input processor should return an exception string. These 
success and exception strings or events are used to define the flow of 

15 pages on the outcome of the execution of the input processor. In 
particular, the success event allows the webflow to handle transitions 
between pages due to the successful execution of an input process. A 
success event may be defined in the webflow properties file using the 
following syntax: 

20 

begin=/home . html 

home . html . link (about ) =/ CMPAP/ solution/ about . html 
home . html .button (login) ^MyLoginIP . input Processor 
MyLoginIP . inputProcessor-com . commerce . . CMPAP . MyLoginIP 
25 MyLoginIP. inputProcessor . success=/CMPAP/ solution/ login. j sp 

[0069] Whatever the process method of the input processor, it 
must return a success string in order to trigger the success event. In 
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one embodiment of the invention, this is as simple as returning the term 
or string "success" shown by the following example: 

import javax.servlet .http.*; 
5 public class MyLoginlP implements Target Processor { 
public String process (HttpServlet Re quest req) 

throws ProcessingException { 
System. out .println (req. getParameter ( "username" ) ) ; 
System. out .println (req. getParameter ( "pasword") ) ; 
10 return "success"; - 

} 

} 



[0070] An exception event can be defined similarly. The 
15 exception event allows the webflow to handle transition between pages 
due to an unsuccessful execution of an input process. Exception events 
can be defined in webflow properties file using the following syntax: 

begin=/home . html 

20 home -html . link (about) =/CMPAP/solution/about .html 
home . html .button ( login) =MyLoginIP . inputProcessor 
MyLoginlP . inputProcessor=com . commerce . . CMPAP . MyLoginlP 
MyLoginlP . inputProcessor . success=/CMPAP/ solution/login. j sp 
MyLoginlP . inputProcessor . exception (MyException) =/CMPAP/solutio 

25 n 

/error . jsp 

[0071] Whatever the process method of the input processor it 
must also issue an exception in order to trigger the exception event. 
30 This need not be a pre-defined message such as the string or phrase 
"success." In one embodiment, any message that is returned other than 
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"success" is treated as an exception. Custom exceptions may be 
recognized if the code is configured such. For example, in the following 
listing, the exception returns a message: 

5 package com . commerce . . CMPAP . CMPAP3 ; 

import com . commerce . webf low . TargetProcessor ; 

import com . commerce . webf low . exception . ProcessingException; 

import javax. servlet .http . * ; 

public class MyLoginIP implements TargetProcessor { 
10 public String process (HttpServletRequest req) 

throws ProcessingException { 

String password=req . getParameter ( "pasword" ) 
if (password. len() <8) 
15 throw new MyExcept i on ( "Password too short") ; 

return "success"; 

} 

} 

20 [0072] This message may then be used to determine custom 
webflow processing. Many different input processors can be defined for 
specific business function needs. These input processors may include 
processors for managing shopping carts, entering shipping information, 
querying payment information, administering order lists, or customer 

25 order histories, and providing sign on mechanisms for users. 

[0073] Input processors extend the syntax used for JSPs in the 
webflow.properties file. For example, if one wants to verify that the 
customer filled in the required form fields for their address before 
sending the customer to the next page, the ValidateAddress input 

30 processor as shown below could be used: 
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Input Processor for Address Validation ' 
################################# 

# ValidateAddress input processor 
################################# 

5 # Invoke the input processor 

addaddress . j sp .button (continue) =ValidateAddressIP . inputprocess 
or 

# Specify the fully qualified class name for the input 
10 processor 

ValidateAddress IP . inputprocessor=com. commerce . ebusiness . 
cus t omer . webf low . Val idat eAddre s s I P 

# Specify the result state for successful execution 

15 ValidateAddressIP. inputprocessor. success=selectaddress .jsp 

# Specify the result state for unsuccessful execution 
ValidateAddressIP . inputprocessor . exception (Process ingExcept ion 
)- 

20 addaddre s s . j sp 

[0074] In the first line of this example, a customer who clicks the 
Continue button causes the flow to be turned over to the inputprocessor 
called ValidateAddressIP. The second line defines the full class name 

25 of the ValidateAddressIP input processor, which will validate the form 
fields. The third and fourth lines make use of the event types defined for 
input processors: success and exception. If the validation is successful, 
the result state indicated by the success event is to load the 
selectaddress.jsp file. If the validation is not successful, the 

30 ValidateAddressIP input processor directs the customer back to 
addaddress.jsp to make corrections. If execution of an input processor 
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is not successful, different result states identified by more than one 
exception event may be specified. 

[0075] In addition to using input processors between JSPs and 
pipelines, more than one input processor, or chain input processors can 
5 be used. In a chaining arrangement, the result state of one successfully 
executed input processor is used as an input to another input processor. 
[0076] Developers may customize the site even further, by 
choosing to create and implement other input processors or define other 
exceptions for use with input processors. New input processors must 
10 implement the InputProcessor interface and must supply an 
implementation for the process method. The process method accepts 
an HTTPServletRequest object as a parameter and returns a string 
(such as success) if execution is successful, as shown in the following 
method signature: 

15 

public String process (HTTPServletRequest request) throws 
ProcessingException 

[0077] All input processors must return a ProcessingException 
20 exception, or one of its subclasses. To obtain the ProcessingException 
exception's exception message, the scriptlet shown below can be used- 
obtaining the ProcessingException Exception Message 
<% String errorMsg = 

25 

(String) request .get Attribute (HttpRequest Const ants . PIPELINEJVIES 
SAGE) ; %> 
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Pipelines 

[0078] A site cannot be truly considered an e-business if it simply 
displays pages and performs some additional tasks with input 
processors. A customer's entire experience relies upon the execution of 

5 back-end business processes that are related to where the customer is 
on the site and what the customer is trying to accomplish. 
[0079] A pipeline is an advanced mechanism that when invoked 
by the webflow initiates execution of specific tasks related to a business 
process. For example, if a customer attempts to move to another page 

10 on the site but the customer's identifying information should be saved 
to a database first, a pipeline can be used. 

[0080] Pipelines are collections of individual pipeline components, 
which can be either Java objects or stateless session EJBs. Pipeline 
components are the parts of a pipeline that actually perform the tasks 
15 associated with the underlying business logic. When these tasks are 
complex, pipeline components may also make calls to external services 
(other business objects). 

[0081] To successfully carry out business tasks, each pipeline 
component must read attributes from a pipeline session and if 
20 necessary, write modified versions of these attributes back to the 
pipeline session, pipeline session are available for the life of the HTTP 
session. 

[0082] One embodiment of the invention allows pipeline 
configurations to be stored in a pipeline properties file. A developer can 
25 modify this file to change the business logic associated with the Web 
pages, without having to edit each page individually. Much like the 
* webflow.properties file specifies the flow of Web pages presented to a 
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customer, the pipeline properties file (pipeline.properties) specifies the 
flow of business logic as the customer moves through each page of the 
site. 

[0083] The pipeline infrastructure provides the functionality of 

5 implementing the business logic determined by the e-commerce 
application. The pipeline infrastructure typically comprises the following 
parts: a pipeline, a pipeline property configuration, one or more pipeline 
components, a pipeline session and a number of pipeline JSP tags. 
[0084] Figure 5 demonstrates a typical pipeline infrastructure in 

10 accordance with an embodiment of the invention. As shown in Figure 
5, data flows from an origin point to a destination point, or a number of 
destination points, through a pipeline 1 64. At the same time information 
about the current session is stored in the pipeline session 166. 
Depending on the output of the pipeline (i.e. whether the process is a 

15 success or not), different destinations may be reached. For example, 
in the case of Figure 5, a successful pipeline operation results in the 
process returning to destinationO 168. A failed pipeline process causes 
an exception and leads to a different destinationl 170 being reached. 
As can be seen in Figure 5, a pipeline comprises a collection of pipeline 

20 components. In one embodiment, pipeline components may be Java 
classes that implement specialized modular small business logic 
features or services. The collective functionality of the pipeline groups 
and pipeline components make up the overall service of the pipeline. 
In effect, the pipeline components operate together to render the 

25 pipeline as a unit of business functionality. Once data enters the 
pipeline, the pipeline itself decides the output, whether it be a success 
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or an exception, and also what the magnitude of those outputs will be. 

[0085] While the flow or order of execution within the pipeline is 
governed by the pipeline itself, the actual flow or order of execution of 
5 the pipelines are configured in the webflow properties file. The pipeline 
name declared in the webflow properties file must match the name 
declared in the pipeline properties file. An example of syntax used to 
configure the flow of pipelines is shown below: 

1 0 origin . event =pipelineName .pipeline 

pipelineName .pipeline . success=destinationl 

pipelineName . exception (PipelineFatalExcept ion) =destination2 

[0086] In this example, a success of the pipeline causes the 
15 webflow to direct the user to destination 1. A failure or an exception 
causes the user to be directed to destination 2. Pipelines themselves 
are configured using the pipeline properties file. They may be 
implemented as either EJB components or Java classes. Although 
pipelines serve as important business functionality, it will be evident to 
20 one skilled in the art that the webflow mechanism may be used 
independently of the pipeline mechanism. 

[0087] Pipeline components, herein after referred to as "PC's", 
can be modular Java classes that form part of the pipeline. The pipeline 
components implement the business logic exhibited by the pipeline. 
25 Pc's provide a well defined self contained service that can be used in 
conjunction with other PC's in a given pipeline. The results of the 
pipeline or pipeline component as it executes the business logic is 
shared with others through the use of the pipeline session. Pipeline 
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components use "set attribute" and "get attribute" methods to bind local 
objects within the pipeline session. Other web components may also 
share this information in the pipeline session. The syntax of the set and 
get methods is shown below: 

5 

void set At tribute (String attributeName, Object attribute); 
Object get Attribute (String attributeName) ; 

[0088] Figure 6 illustrates a pipeline session initialization process. 

10 The pipeline session is usually initialized by an input processor IP. Input 
processors are used to preprocess and to validate data before the 
business logic itself is executed. Pipeline JSP tags are used to access 
the content of a pipeline session using a special tag library. The syntax 
of a pipeline tag used to access the pipeline session properties is given 

15 below: 

<pref ix:getPipelineProperty 

propertyName= u propertyName" 
returnName = M variableName" 
20 returnType = n variableType"/> 

[0089] In this example, the tag retrieves a property n^me. The 
property name stores it in a variable having a variable name and a type 
variable type. Similarly to input processors pipelines return results. 
25 Typically this result will be either a success or an exception. A success 
usually results in the pipeline performing some business function. An 
exception usually results in an abort or a failure to perform that business 
function. In one embodiment, pipeline components can throw three 
exceptions, either a non-fatal exception, a fatal exception, or a remote 
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exception. Fatal exceptions, hereinafter referred to as PFE, are thrown 
by a pipeline component and causes the whole pipeline to fail. The 
pipeline itself generates an exception event if any of its PC's throw a 
PFE. On the other hand, pipeline exceptions which are non-fatal, do not 

5 cause the whole pipeline to fail. In a non-fatal pipeline exception, one 
pipeline component causes the exception. But the pipeline itself 
continues. Pipelines themselves do not generate an exception event 
when a single PC throws a PFNE. Returning to Figure 5, the pipeline 
therein shows what happens when a PFE or PFNE is returned. Within 

10 the pipeline 164 a number of pipeline components are shown. A PFE 
172 resulting from any of these pipeline components causes an 
exception to be thrown by the pipeline overall. A PFE, alternatively, 
does not result in an overall pipeline exception, but causes the pipeline 
to continue to its final destination 168. 

15 [0090] Generically, pipeline definitions can be written as: 

<pipelineName> . componentList 
<pipelineName> . isTransactional=<true | f alse> 

20 where componentList is a comma-separated list of pipeline components 
to be executed in sequence. Once all pipeline definitions are complete, 
the developer must specify definitions for each pipeline component in 
the pipeline. Each pipeline component definition consists of three 
properties: className which specifies the Name of the class that 

25 implements the pipeline component, jndiName which specifies the name 
of the session bean that implements the pipeline component, and 
isEJBSessionBean which Specifies whether or not the pipeline 
component is a session bean. 
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[0091] The pipeline.properties file contains pipeline definitions, 
which include: 

A pipeline name. 

A list of its associated pipeline components in order of execution. 
5 • A value for the isTransactional pipeline property, indicating 
whether or not all the pipeline components in the pipeline will participate 
in a transaction. 

[0092] The following is a pipeline definition that might be used in 
the pipeline.properties file: 

10 

orderPipeline=CalculateTaxPC, CalculateDiscountPC, TotalCartCost 
PC 

orderPipeline . isTransactional=true 

15 [0093] In this example, a pipeline called orderPipeline consists of 
three pipeline components (CalculateTaxPC, CalculateDiscountPC,- 
TotalCartCostPC). The orderPipeline is also transactional. The 
corresponding pipeline component definitions that might be used in the 
pipeline.properties file are shown below. 

20 

CalculateTaxPC . classname=com . commerce . ebusiness . order . 
pipeline . CalculateTaxPC 
CalculateTaxPC. isEJBSessionBean=f alse 
CalculateTaxPC . jndiName= 
25 CalculateDiscountPC . classname=com. commerce . ebusiness .order 
. pipeline . CalculateDiscountPC 
CalculateDiscountPC . isEJBSessionBean= false 
CalculateDiscountPC . jndiName= 



30 TotalCartCostPC . c las sname= com. commerce . ebusiness . order 
pipeline . TotalCartCostPC 
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TotalCartCostPC . isEJBSessionBean=true 

TotalCartCostPC . j ndiName= com . commerce . ebusiness . order. . 
pipeline . TotalCartCostPC 

5 

[0094] Like the webflow, the pipeline configuration, as stored in 
the pipeline properties file, can be dynamically modified to effect 
dynamic changes to the pipeline itself. To dynamically modify a site's 
pipelines, these steps are used: 
10 1 . Start a simple text editor like Notepad. 

2. Open the pipeline properties file. 

3. Modify the file as necessary, using the syntax described in the 
previous sections. 

4. Save the modified file. 

15 The server does not need to be restarted for the changes to take 

effect. 

[0095] The pipeline. properties file provides an easy way to 
eliminate pipeline components without the need for advanced 
20 programming skills. For example, a devloper might want to eliminate a 
pipeline component that performs your tax calculations in a 
CommitOrder Pipeline. The definition in a default pipeline.properties file 
for a CommitOrder Pipeline is shown below: 

25 # CommitOrder 

CommitOrder . componentList-CommitOrderPC , Authorize Payment PC , 
TaxCalculateAndCommitLineLevelPC 
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[0096] To eliminate a pipeline component, these steps are 
followed: 

1 . The pipeline.properties file is opened and each reference to the 
pipeline component to be eliminated is removed. For example, if tax 

5 calculations are not required, then all tax calculation pipeline 
components are removed from the pipeline definition, as shown below: 

# CommitOrder 

CommitOrder . component Li st=CommitOrderPC, Author izePayment PC 

10 

2. If necessary, the related JSPs are edited to eliminate places in 
the user interface where the information is gathered. 

3. If in step 2 an entire JSP was removed, the developer must open 
the webflow.properties file and change any reference(s) to bypass it. 

15 

[0097] The pipeline.properties file also provides an easy way to 
modify the sequence of pipeline components, without the need for 
advanced programming skills. 

[0098] To reorder a pipeline component, the pipeline.properties 
20 file is modified to change the order that the pipeline components are 
listed in the pipeline definition. 

[0099] Using the same CommitOrder Pipeline example, if one 
wanted to authorize the payment after calculating the tax instead of 
before it (as in the default OrderCommit Pipeline), one could use the 
25 following entry: 



# CommitOrder 

CommitOrder . component Li st=CommitOrderPC, 
TaxCalculateAndCommitLineLevelPC, AuthorizePaymentPC 
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Pipelines in the Webflow 

[0100] Figure 7 illustrates how the various technology categories 
interact to preserve the Commerce Server design model and is essential 
5 to understanding how to customize and extend the webflow and pipeline 
mechanisms. 

[0101] Pipelines can be used in the webflow. properties file to 
initiate execution of the business logic required for a particular page. 
Each pipeline must first be invoked by the webflow, and then followed 
10 by a success and exception path. For example, if a customer were to 
submit their order for processing, the orderPipeline might be 
represented in the webflow.properties file as shown below: 

shoppingcart . j sp .button (submit) =order Pipe line .pipeline 
15 orderPipeline .pipeline . success=commitorder . j sp 

orderPipeline .pipeline . exception (PipelineFatalException) = 
shoppingcart . j sp 

[0102] The first line indicates that when a customer clicks on the 
20 Submit button, the webflow will turn control over to the pipeline called 
orderPipeline. If the pipeline executes successfully (that is, if each 
component in the pipeline executes without error), the second line sends 
the customer to a page that allows the customer to commit the order. If 
the pipeline does not execute successfully, the third line specifies the 
25 exception and directs the customer back to the shopping cart page. 
[0103] To customize a site even further, a developer might 
choose to create and implement custom pipelines or define custom 
exceptions for use with pipelines. 
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[0104] The webflow and pipelines are designed for easy 
extensibility. For example, if organizational requirements dictate the use 
of a new business process, a Java/EJB programmer can utilize the 
existing webflow and pipeline infrastructure to create and incorporate 

5 these components into the system. 

[0105] Although pipelines and their components are reusable, 
they must relate to a particular customer's experience on the 
e-commerce site to make their execution relevant. For this reason, 
pipeline components always operate on a pipeline session. 

10 [0106] Pipeline sessions are used to keep track of information 
gathered from customers and the data modified by pipeline components 
as a customer moves through the site, and to maintain this state of the 
business process. A pipeline session is an object that is created and 
stored within the HTTP session, with the goal of providing a single point 

15 of communication for all pipeline components in a given pipeline. 
Additionally, pipeline sessions provide central access and storage for all 
external classes that may also need to update the pipeline session. 
[0107] The pipeline session is comprised of many name/value 
pairs called attributes. Pipeline components act on particular attributes 

20 that exist within the pipeline session, and may also add new attributes 
as necessary. 

[0108] The pipeline session provides an API that allows a 
developer to add pipeline session attributes. All attributes in the pipeline 
session can have one of two scopes: pipeline Session scope or Request 
25 scope. The method signature for creating pipeline session attributes is: 



public void set Attribute (String key, Object attribute, int 
scope) ; 
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where the value scope isgiven as either PipelineConstants. 
PIPELINE_SESSION_SCOPE or 
PipelineConstants.REQUEST_SCOPE. 

5 [0109] In the pipeline Session scope, the attribute exists in the 
pipeline session until the end of the current HTTP session. In the 
Request scope, the attributes are made available in the 
HTTPServletRequest, and these attributes should be accessed via the 
getPipelineProperty JSP tag (that is, the attributes exist only for the life 

10 of an HTTP request). 

[0110] Pipeline Session and Request scoping differ by how long 
the attribute is retained. When an attribute is specified with the Request 
scope, it is available from the time it is set, up to and including the 
display of the next JSP. The attribute is automatically deleted when a 

15 new request starts. Therefore, Request scope is useful for temporary 
objects that are only needed for one page, for example, search results 
from the product catalog are stored as Request-scoped attributes. 
Attributes that may be longer lived can be specified as pipeline Session 
scope, which cause them to be retained throughout the customer's 

20 session. If a pipeline session attribute is only required for the current 
request, then Request scope can be used. 

[0111] Each time the pipeline session is updated, the HTTP 
session can be updated so that the pipeline session is replicated across 
all the nodes in a cluster environment. 
25 [0112] In addition to using the pipelines and pipeline components 
provide a developer may create their own pipelines and pipeline 
components. New pipeline components must implement the 
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pipelinecomponent interface and must supply an implementation forthe 
process method. The process method accepts a pipelinesession object 
as a parameter, and returns updated pipelinesession objects if the 
execution is successful, as shown in the following method signature: 

5 

public Pipelinesession process (Pipelinesession session) throws 
RemoteException, PipelineNonFatalException, 
PipelineFatalException 

10 Pipeline Component Exceptions 

[01 1 3] Pipeline components may issue a PipelineFatalException 
to signify that the component has failed. When this occurs, no further 
pipeline components are executed and if the pipeline is transactional, 
the transaction will be rolled back. To obtain the PipelineFatalException 
15 exception's exception message, the scrip shown below can be used: 

Obtaining the PipelineFatalException Exception Message 
<% String errorMsg = 

20 

(String) request .getAt tribute (HttpRequest Const ants . PIPELINE_MES 
SAGE) / %> 

[0114] Pipeline components may also issue a 

25 PipelineNonFatalException to indicate that the component has failed, 

but that subsequent pipeline components should be executed. A 

pipeline component may also issue a RemoteException. The webflow 

integrates with these exceptions as follows: 

PipelineFatalException: If any component in a pipeline issues a 
30 PipelineFatalException or a class derived from PipelineFatalException, 



WO 02/27510 



PCT/US01/30260 



41 

besides aborting the pipeline and the transaction, the webflow will 
perform an exception search on the exception thrown. 

RemoteException: If the pipeline issues a RemoteException, it 
is treated as a server error and the servererror jsp is displayed. 

5 

[0115] When an exception search is performed, the webflow 
looks for the exact exception found as the event. If this exception is not 
found, the webflow begins looking through the search order. 
[0116] Pipeline components can be implemented as either 
10 stateless session EJBs or as Java objects. An implementing class that 
is a stateless session EJB must meet the following requirements: 

It must declare and implement a create() method in the bean's 
Home interface that takes no arguments and returns the appropriate 
Remote interface. 

15 It must declare and implement the process() method as part of its 

Remote interface. 

Stateful versus Stateless Pipeline Components 

[0117] Whether pipeline components are implemented as 

20 stateless session EJBs or as Java objects, pipeline components 
themselves should be stateless. The business logic implemented in 
pipeline components should only depend upon the PipelineSession 
object, the database, and other external resources. Should a developer 
define any instance variables, static variables, or static initializers within 

25 a pipeline component, the results may be unpredictable. 
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Transactional versus Non-Transactional Pipelines 
[0118] If all pipeline components within the pipeline will be 
invoked under one transaction, the respective pipeline's isTransactional 
property should be set to true in the pipeline definition (within the 
5 pipeline.properties file). Transactional pipelines provide support for 
rolling back the database transaction and for making changes to the 
pipeline session. If a transactional pipeline fails, any database 
operations made by each of its pipeline components are rolled back. If 
a pipeline component in a transactional pipeline is implemented as a 

10 stateless session EJB, then its transaction attribute must be Required. 
Also, each of the pipeline components in a transactional pipeline must 
have the correct transaction flag. Transaction flags indicate whether or 
not each bean will participate in the transaction. If the pipeline's 
isTransactional property is true and the participating pipeline 

15 components (beans) have their transaction flag set to never, then the 
pipeline may fail to execute. Similarly, if the pipeline's isTransactional 
property is false and the pipeline components have the transaction flag 
set to mandatory, the pipeline may also fail to execute. If a pipeline 
component in a transactional pipeline is implemented as a simple Java 

20 object, then for all database operations, the pipeline component must 
use the Transactional DataSource associated with the connection pool, 
as defined in the weblogic.properties file. A transactional pipeline 
containing pipeline components implemented as simple Java objects 
commits the transaction upon success, and rolls back the transaction 

25 upon failure. 
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Session Timeouts 

[0119] In any Web application, the HttpSession is usually 
short-lived. Therefore, every time the HttpSession is accessed, it must 
be evaluated to determine whether the session is new or whether the 

5 client has joined the current session. If the session is new and an 
attempt is made to access the PipelineSession from the HttpSession, 
then a null value will be returned unless it is recreated. 
[0120] As part of handling session timeouts, each class that 
implements the PipelineGomponent interface should determine whether 

10 or not a required attribute exists in the PipelineSession object. If the 
attribute does not exist, the subclass should throw an 
InvalidPipelineSessionStateException exception. 

Webflow and Pipeline JSP Tags 
15 [0121] An embodiment of the invention provides JSP tags 
specifically related to the webflow and pipeline mechanisms. 
[0122] The webflow JSP tags are utility tags that simplify the 
implementation of JSPs that utilize the webflow mechanism. To import 
the webflow JSP tags, the following code may be used: 

20 

<%@ taglib uri="webf low.tld" prefix=" webflow" %> 

[01 23] The getValidatedValue tag is used in a JSP to display the 
fields in a form that a customer must correct. The attributes that can be 
25 used with the getValidatedValues JSP tag include: 

fieldName: The name of the field for which the status is desired. 
fieldValue: The current value of the field as set by a previous 
invocation of the page 



WO 02/27510 



PCT/US01/30260 



44 

fieldStatus: The processing status of the field, which may be 
unspecified, invalid, or valid. 

[0124] These fields are determined and marked by an input 
5 processor after performing its validation activities. All InputProcessors 
use a ValidatedValues object to communicate which fields were 
successfully processed as well as those that were determined to be 
invalid. 

10 ValidatedValues Java Class 

[0125] The ValidatedValues class allows a Java/EJB programmer 
who writes an InputProcessor to report the status of processed form 
fields back to the commerce engineer/JSP content developer. 
The constructor for the ValidatedValues class takes an HTTPSession 

15 as a parameter, as shown in the following method signature: 

public ValidatedValues ( javax. servlet .http .HttpSession s) 

[0126] The public methods used to convey the status of the 
20 validation through the getValidatedValue JSP tag include: 

public String getStatus (String name): Retrieves the status for the 
specified field, which may be unspecified, invalid, or valid, 
public void setStatus (String name, String value): Sets the status for 
25 the specified field. 

public String getValue (String name): Retrieves the current value for 
the specified field. 
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[0127] An example of how one might use the getValidatedValue ' 
tag is shown below. When used in a JSP, this sample code will obtain 
the current value and processing status of the <field_name> form field. 

5 <webflow: getValidatedValue f ieldName="<f ield_name>" 
fieldValue="<field_yalue> !I f ieldStatus=" status" /> 

[0128] The pipeline JSP tags are used to store and retrieve 
attributes in a pipeline session. To import the pipeline JSP tags, the 
10 following code can be used: 

<%@ taglib uri= "pipeline . t Id" prefix= "pipeline" %> 

[0129] The getPipelineProperty JSP tag retrieves a named 
15 attribute (property) from the pipeline session object, from a property of 
one of the objects that has been retrieved from the pipeline session, or 
from the request. The attributes that can be used with the 
getPipelineProperty JSP tag include: 

20 attributeScope: Scope of the attribute to locate. 

(PipelineConstants.PIPEUNE_SESSION_SCOP 
E or PipelineConstants.REQUEST.SCOPE) 
pipelineObject: Name of the object in the pipeline session in 
which to locate the specified attribute. 
25 propertyName: Name of the attribute to locate. 

retumName: Name of the variable that will contain the value of 

the attribute. 

returnType: A valid type for the returned attribute. 
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[0130] An example of how a developer might use the 
getPipelineProperty tag is shown below. When used in a JSP, this 
sample code will retrieve an attribute named <property_name> and 
5 store it in a variable named <returnjname>. The type of this variable will 
be <returnjype>, and the scope to which this attribute belongs is 
specified by <attribute_scope>. 

<pipeline : getPipelineProperty propertyName= " <property_name> 11 
10 returnName= " <return_name> " returnType= » <return_type> " 
attributeScope="<%=<attribute_scope>%> H /> 

[0131] The setPipelineProperty JSP tag sets a named attribute 
(property) to the pipeline session object or to a property of one of the 
15 objects that has been retrieved from the pipeline session. The attributes 
that can be used with the setPipelineProperty JSP tag include: 

pipelineObject: Name of the object in the pipeline session in 
which to set the specified attribute. 
20 propertyName: Name of the attribute to set. 
propertyValue: Value of the attribute to set. 

[0132] If pipelineObject is not specified, then the given property 
and its value will be set to the pipeline session. If the pipelineObject is 
25 specified, then the object must implement the set<PropertyName>() 
method, which takes two parameters: a property name (String) and a 
property value (Object), as shown in the following method signature: 
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public void set<PropertyName> (String 

proper tyName , j ava . lang . Ob j ect property Value) ; 

[0133] If the set<PropertyName>()method is not implemented, an 
5 exception will be thrown during the processing of the JSP that has the 
setPipelineProperty tag in it. 

An example of how one might use the setPipelineProperty tag is shown 
below. When used in a JSP, this sample code will set the property 
10 named <propertyjiame> of the <pipeline_object_name> with the value 
specified in <property_value>. 

<pipeline : setPipelineProperty propertyName= n <property_name>" 
propertyValue= 11 <property_value> " 
1 5 pipelineOb j ect =s » <pipeline_ob j ect__name> " / > 

Web Site Implementation 

[01 34] Figure 8 illustrates a simple example of how the webflow 
may be used in a Web site implementation to modify the flow of the 

20 Web site logic. As shown in Figure 8, the webflow initially causes the 
user to flow from a home page 210, through a login servlet212, an input 
processor 214, and a pipeline 216 to a series of other Web pages 222. 
The pipeline 216 includes a number of paths 218, 226, 228 depending 
on the success (or not) of the login. By simply modifying the webflow 

25 properties file, a developer can add an additional module or step, for 
example an additional login verification step 230, without modifying any 
of the actual underlying HTML or JSP code. In this manner the 
business logic of the Web site is changed in a fundamental way, without 
requiring any change in the code, and without requiring any down-time. 



WO 02/27510 



PCT/US01/30260 



48 

[0135] Figures 9-18 illustrate a more detailed example of the use 
of a webflow properties file together with a link and a button event to 
create a simple Web site. In this example the Web site comprises three 
web pages: home.html, about.html and login.html. 

5 [0136] The first step illustrated in Figure 9 is to declare a begin 
event that points to the home page. Following this, a link event called 
about is used to transition between the home.html and the about.html 
page. The HTML code representing the home page must also be 
modified to declare the link event as shown in Figure 10. This event is 

10 used to call the webflow process to allow the transition to the about 
page. 

[01 37] Figure 1 1 illustrates an example of the about page and the 
code used to show a simple transition between pages using the webflow 
process. The next step in configuring the example webflow is to add a 

15 button event. In this example, as shown in Figure 12 a button event 
declaration called login is added to provide a transition from home.html 
page to the login.html page. The button events must be triggered by 
modifying the HTML code on the home page to invoke the webflow 
mechanism whenever the button is depressed. 

20 [0138] Figure 13 illustrates an example of the home page 
together with the login button in showing the call to the webflow 
application, "commercewf". 

[0139] Figure 14 illustrates a login page, which in this example 
is a JSP that has an access to the HTML request parameters through 
25 a request object. It can be seen in this example that the webflow 
process decides in each instance what the transition should be. The 
home page itself does not reference the about page, ie links do not 
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need to be hard coded into the home page. The home page merely 
informs the webflow that a link event named about has occurred in the 
page. The webflow then decides what the transition should be. The 
developer of the e-commerce site can change the order of the pages 
5 by maintaining the webflow properties file. No HTML coding is needed 
to change the flow of logic between to verify the login password. In this 
example, if the password is less than eight characters the input 
processor throws an exception and the webflow transitions to an error 
page. 

10 [01 40J The first ste P in the process is illustrated in Figure 15, in 
which an input processor called MyLoginIP is declared in the webflow 
properties file. A success event is then also defined in the webflow 
properties file that transitions to the login JSP page upon successful 
login, as shown in Figure 16.. 

15 [0141] As shown in Figure 17, this success event is triggered 
whenever the input processor returns the string "success". Figure 18 
illustrates the mechanism by which an exception event can be added to 
the web page. In this case an exception event is added to handle 
exceptions thrown by the input processor. 

20 [0142] As shown in Figures 19-20, the webflow will transition to 
the error page when the input processor throws an exception. In this 
case the user is presented with an HTML page that indicates an error 
has occurred and gives the user some additional information to enable 
them to rectify the error. 

25 Figure 21 illustrates how this simple web page can be expanded 

to include a pipeline application. In this example the pipeline application 
comprises an order form that gathers billing information from the client. 
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Form input fields have names such as user name, address, city, state 
and zip. A first step in this process is to submit the form to validate an 
input processor (IP) for validation. The input processor validates the 
fields, retrieves a pipeline session and populates the pipeline session 

5 with the attributes passed to it by the form. 

[0143] Figures 22-25 illustrate the additional steps needed to 
configure the pipeline process. The success of the input processor 
triggers the execution of the validate PL pipeline which contains two 
pipeline components: a validate user pipeline component 

10 (validateuserpc), which gets the user name property and validates that 
the user is registered; and a validate card pipeline component 
(validatecardpc), which gets the user's credit card number and validates 
that the card is in fact an authorized one. Successful execution of this 
pipeline invokes the Java servlet page, validated. JSP. The validate. JSP 

15 Servlet imports the pipeline tag library, gets properties from the pipeline 
session and prints out all the properties and their values. These 
properties and values are then used to actually process the order. 

Invocation Life Cycle 

20 [01 44] Figures 26-28 illustrate life cycles for various applications 
and features in accordance with the invention. Figure 26 shows the 
pipeline session life cycle for a JSP page. In Figure 26, the JSP invokes 
the session manager, which in turn invokes the pipeline session. The 
pipeline session may be created if needed. From then on, the JSP 

25 interacts directly with the pipeline session through a series of Get 
attributes or said attribute commands. 
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[0145] Figure 27 illustrates the pipeline session life cycle for an 
input processor. In Figure 27, a web server passes an initial call to the 
webflow mechanism. The webflow mechanism invokes the input 
processor which in turn requests a new session from the session 
5 manager. This session may be created if needed. From then on, the 
input processor processes requests to and from the pipeline session 
through a series of get attribute or said attribute commands. 
[0146] Figure 28 illustrates the pipeline session life cycle for a 
pipeline component. In Figure 28 the webflow requests a session 
10 manager to create a new pipeline session. The pipeline processor then 
generates a new pipeline component. 

[0147] Theforegoing description of preferred embodiments of the 
present invention has been provided for the purposes of illustration and 
description. It is not intended to be exhaustive or to limit the invention 

15 to the precise forms disclosed. Obviously, many modifications and 
variations will be apparent to the practitioner skilled in the art. The 
embodiments were chosen and described in order to best explain the 
principles of the invention and its practical application, thereby enabling 
others skilled in the art to understand the invention for various 

20 embodiments and with various modifications that are suited to the 
particular use contemplated. It is intended that the scope of the 
invention be defined by the following claims and their equivalence. 



25 
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Claims: 

What is claimed is: 

5 1. A system for managing the logic flow of a user application in an 
online environment, comprising: 

an index of logical elements for use in said user application; and, 
a control module, which uses said index of logical elements to 
determine which logical elements of said user application are presented 
10 to a user in the online environment. 



2. The system of claim 1 wherein said index of logical elements 
comprises an entry for each logical element of the user application. 

15 

3. The system of claim 2 wherein said entry for each logical element 
of the user application comprises a source location and a target location 
representing a logical sequence of application steps. 

20 

4. The system of claim 3 wherein the source location and the target 
location may be modified to reflect a different logical sequence of 
application steps. 

25 

5. The system of claim 1 wherein the logical element comprises an 
application pipeline which performs a series of application steps. 
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6. A method of managing the logic flow of a user application in an 
online environment, comprising: 

providing an index of logical elements for use in said user 
5 application; and, 

consulting said index to determine which logical elements of said 
user application are presented to a user in the online environment. 

10 7. The system of claim 6 wherein said index of logical elements 
comprises an entry for each logical element of the user application. 

8. The system of claim 7 wherein said entry for each logical element 
15 of the user application comprises a source location and a target location 

representing a logical sequence of application steps. 

9. The system of claim 8 wherein the source location and the target 
20 location may be modified to reflect a different logical sequence of 

application steps. 

1 0. The system of claim 9 wherein the logical element comprises an 
25 application pipeline which performs a series of application steps. 

11. A system for managing the flow of an application, wherein the 
application includes a plurality of application nodes, comprising: 



WO 02/27510 



PCT/US01/30260 



54 

a webflow properties file for storing a plurality of origin event 
pairs, wherein each of said origin event pairs comprises a set of origin 
nodes within the application together with a set of event-based 
transitions between said nodes; and, 
5 a webflow processor for parsing said webflow properties file on 

a request of said application, to determine the flow of said application 
throughout said application nodes. 

1 2. The system of claim 1 1 wherein said webflow processor is called 
10 by said application during an event, together with an origin event pair, 

in order to parse said webflow properties file, locate said origin event 
pair, determine said transition and manage said application flow. 

13. The system of claim 12 wherein said webflow processor parses 
15 said webflow properties file dynamically, to determine said application 

flow in real-time. 

14. The system of claim 1 3 wherein said webflow properties file may 
be modified, by modifying one or more of said origin event pairs, to 

20 effect a dynamic change in said application flow. 

15. The system of claim 11 wherein said application nodes include 
a presentation node for presenting static information between events. 

25 16. The system of claim 1 1 wherein said application nodes includes 
an action node for generating events based upon data received at said 
application. 
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17. The system of claim 16 wherein said action node is an input 
processor for examining said received data, and determining origin 
event pairs based on said examining. 

5 1 8. The system of claim 1 6 further comprising: 

a pipeline session for storing said data for use by other nodes. 

1 9. The system of claim 1 8 wherein said action node is a pipeline for 
operating on said data to create a new data, and storing said new data 

10 in said pipeline session, 

20. The system of claim 19 wherein said pipeline comprises a 
plurality of pipeline components, each of which may modify said data 
according to a predefined business function. 

15 

21. The system of claim 11 wherein said application is a Web 
application. 

22. The system of claim 1 1 wherein said Web application comprises 
20 a plurality of Web pages, further wherein each of said plurality of Web 

pages is represented by an application node. 

23. The system of claim 22 wherein said Web pages include any of 
HTML, or JSP code. 

25 

24. The system of claim 17 wherein said application comprises a 
plurality of Web pages, further wherein each of said plurality of Web 
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pages is represented by an application node, and wherein said input 
processor examines data received at a form on one of said Web pages. 

25. The system of claim 19 wherein said application comprises a 
5 plurality of Web pages, further wherein each of said plurality of Web 

pages is represented by an application node, and wherein said pipeline 
operates on data received at a form on one of said Web pages. 

26. A method for managing the flow of an application, wherein the 
10 application includes a plurality of application nodes, comprising: 

storing in a webflow properties file a plurality of origin event pairs, 
wherein each of said origin event pairs comprises a set of origin nodes 
within the application together with a set of event-based transitions 
between said nodes; and, 
1 5 parsing at a webflow processor said webflow properties file on a 

request of said application, to determine the flow of said application 
throughout said application nodes. 

27. The method of claim 26 including: 

20 calling said webflow processor during an event, together with an 

origin event pair, in order to parse said webflow properties file, locate 
said origin event pair, determine said transition and manage said 
application flow. 

25 28. The method of claim 27 including 

parsing said webflow properties file dynamically, to determine 
said application flow in real-time. 
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29. The method of claim 28 wherein said webflow properties file may 
be modified, by modifying one or more of said origin event pairs, to 
effect a dynamic change in said application flow. 

5 30. The method of claim 26 wherein said application nodes include 
a presentation node for presenting static information between events. 

31 . The method of claim 26 wherein said application nodes includes 
an action node for generating events based upon data received at said. 

10 application. 

32. The method of claim 31 wherein said action node is an input 
processor for examining said received data, and determining origin 
event pairs based on said examining. 

15 

33. The method of claim 31 further comprising: 

storing said data in a pipeline session for use by other nodes. 

34. The method of claim 33 wherein said action node is a pipeline 
20 and includes the step of: 

operating on said data to create a new data, and storing said new 
data in said pipeline session. 

35. The method of claim 34 wherein said pipeline comprises a 
25 plurality of pipeline components, each of which may modify said data 

according to a predefined business function. 
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36. The method of claim 26 wherein said application is a Web 
application. 

37. The method of claim 26 wherein said Web application comprises 
5 a plurality of Web pages, further wherein each of said plurality of Web 

pages is represented by an application node. 

38. The method of claim 37 wherein said Web pages include any of 
HTML, or JSP code. 

10 

39. The method of claim 32 wherein said application comprises a 
plurality of Web pages, further wherein each of said plurality of Web 
pages is represented by an application node, and wherein said input 
processor examines data received at a form on one of said Web pages. 

15 

40. The method of claim 34 wherein said application comprises a 
plurality of Web pages, further wherein each of said plurality of Web 
pages is represented by an application node, and wherein said pipeline 
operates on data received at a form on one of said Web pages. 

20 
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